home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / graphics / vuimg331.zip / VUIMG.TXT < prev   
Text File  |  1992-03-20  |  69KB  |  1,562 lines

  1. ==============================================================================
  2.  
  3.                   VUIMAGE(tm) (Version 3.31) (Shareware)
  4.                 GIF*/TIFF/PCX Format Picture Viewer/Printer
  5.         Copyright (C) 1989-1992 Offe Enterprises. All rights reserved.
  6.  
  7.                                 USERS MANUAL
  8.  
  9.  Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  10.           Tel: 708-357-6679  Fax: 708-357-6683  BBS: 708-357-6680
  11.  
  12.    ------------------------------------------------------------------------ 
  13.   | At the end of this manual you can find a list of changes in this       |
  14.   | version, a list of common problems and solutions, tips on getting the  |
  15.   | best performance from the software, and a list of sources from where   |
  16.   | the latest shareware version can usually be obtained.                  |
  17.    ------------------------------------------------------------------------ 
  18.  
  19.  
  20.  
  21.    *******************************  NOTICE  ********************************
  22.    *                                                                       *
  23.    *    This program, and all supporting programs and documentation are    *
  24.    *    provided "as is" without warranty of any kind, either expressed    *
  25.    *    or implied, including but not limited to the implied warranties    *
  26.    *    of merchantability and fitness for a particular purpose.  In no    *
  27.    *    event will  Offe Enterprises  be liable  to you for any damages    *
  28.    *    arising out of the use or  inability to use this program and/or    *
  29.    *    all supporting programs and documentation.                         *
  30.    *************************************************************************
  31.  
  32. *  GIF and "Graphics Interchange Format" are trademarks (tm) of Compuserve,
  33.    Inc., an H&R block company.  PostScript is a trademark of Adobe Systems, Inc.
  34.    VUIMAGE, VUIMAGE PLUS, TBG and SCRtoPS are trademarks of Offe Enterprises.
  35.  
  36.    All prices and other information are subject to change without notice.
  37.  
  38. ==============================================================================
  39.  
  40. FEATURES
  41. --------
  42.  
  43. Offe is proud to bring you our GIF/TIFF/PCX display/print software for the
  44. IBM PC family.  Its main features are:
  45.  
  46.  *  Superfast display or print of:  
  47.      - GIF, PCX and uncompressed bilevel/grayscale TIFF files
  48.      - compressed bilevel TIFF files (compression type 
  49.        CCITT G3-1D, CCITT Group 4 or Packbits) 
  50.      - 8-bit palette uncompressed TIFF files
  51.  
  52.  *   Optional image preloading to conventional or extended memory
  53.  
  54.  *   Support for a wide variety of display types:
  55.      - CGA, Hercules, EGA, MCGA, VGA, 6300, Tandy, 8514/A, SuperVGA
  56.      - VESA SuperVGA driver for all SuperVGA cards that have VESA BIOS support.
  57.        Supports the following VESA standard modes (if available in card):
  58.         800x600x16, 1024x768x16, 1280x1024x16
  59.         640x400x256, 640x480x256, 800x600x256, 1024x768x256, 1280x1024x256
  60.      - driver for 320x400x256, 360x480x256 and 800x600x16 modes on 100% IBM VGA
  61.        register compatibles 
  62.      - excellent color rendition in all video modes
  63.      - various dithering options for two-color video modes
  64.      - automatic/manual video mode selection capability
  65.      - display picture within a window on screen
  66.  
  67.  *  Print images
  68.      - print entire image, set your own print size
  69.      - print to laserjet and dot-matrix printers
  70.      - seven dithering options
  71.  
  72.  *  Pre-scaling, Zoom, Pan and Auto-scale features
  73.     - many image pre-scaling (scaling image before displaying it) options
  74.       including various autoscale, no scale, and manual scale from 1% to 999%
  75.       vertically and horizontally
  76.     - Zoom in and Zoom out using the "+" and "-" keys
  77.     - user adjustable Zoom factor
  78.     - Panning: cursor keys move the screen window over different sections of
  79.       picture
  80.     - user adjustable pan amount
  81.     - autoscale key to autoscale image after it has been displayed
  82.  
  83.  *  Color Control: adjust brightness, contrast etc. afer image is on screen
  84.  
  85.  *  User-friendly, multiple interfaces
  86.     - menu-driven: select options and files to view via menus.  File(s) can
  87.       be tagged or specified by file numbers.  When a list of files is 
  88.       selected, move forward/backward through the list or continuously
  89.       repeat the list.  List directory alphabetically, by date, by size or
  90.       by order on disk and list in short, medium or long formats
  91.     - commandline driven: specify options via commandline parameters
  92.     - abort single picture or list of pictures in the middle
  93.     - returns DOS errorlevel value (useful in batch files and when
  94.       called as a sub-program by other programs)
  95.     - user selectable menu screen colors
  96.     - get quick picture info without displaying picture
  97.     - show brief or detailed image information as each picture is displayed
  98.     - autoselect file type (based on filename) or manual select file type
  99.  
  100.  *  GIF89a support: Supports plain text, graphics control, comment extensions,
  101.     restore to background etc.
  102.  
  103.  *  Utilities: includes utility to convert interlaced GIFs to non-interlaced
  104.  
  105.  *  Low memory requirements:  can work with as little as 180K* of free memory 
  106.     even on very large images
  107.  
  108. * GIF89a images that use "restore to previous" function need may need more
  109.   memory for complete restoral to previous.  Also, the "image preload" feature
  110.   uses additional conventional or extended memory.
  111.  
  112.  
  113. ==============================================================================
  114.  
  115. FOR REGISTERED USERS
  116. --------------------
  117.  
  118. Registered users get VUIMAGE PLUS(tm) Version 3.31, our non-shareware version
  119. of the program with the following added features:
  120.  
  121. - printed manual
  122.  
  123. - the ability to save the program configuration
  124.  
  125. - menus may be disabled and file (or files) to be shown may be specified from
  126.   the command line (in this mode, the image may be left on the screen when
  127.   the program ends).
  128.  
  129. - ability to display images by specifying a slideshow file (file containing
  130.   names of images to display and other parameters).
  131.  
  132. - ability to specify the print options (printer type, print size, printer port
  133.   etc.) from the command line 
  134.  
  135. - ability to invert images by pressing the "i" key after the picture has been 
  136.   displayed on the screen 
  137.  
  138.  
  139.  
  140. REGISTRATION
  141. ------------
  142.  
  143. This version of the program is released as shareware. It is not free and is
  144. not in the public domain.  Private, non-commercial users are requested to
  145. register and support its continued development.  Registered users get
  146. VUIMAGE PLUS(tm) Ver 3.31.  To register, please use the order form supplied
  147. with this package, or send your name, address and phone number(s) with the
  148. registration fee of US $40.00** (outside US, please add $5.00) to:
  149.  
  150. Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  151. Tel: (708)-357-6679,  Fax: (708)-357-6683
  152.  
  153. Any use of VUIMAGE(tm) in a commercial environment is illegal and is strictly
  154. prohibited.  Commercial users should purchase VUIMAGE PLUS(tm), the
  155. non-shareware version.  Volume discounts and site licenses are available for
  156. VUIMAGE PLUS(tm).  Contact Offe Enterprises for customized versions.
  157.  
  158.  
  159. DISTRIBUTION
  160. ------------
  161.  
  162. You may make copies of the program files for VUIMAGE(tm) and the documentation
  163. VUIMG.TXT (this file) together and distribute them to others, upload to
  164. bulletin boards etc. for non-commercial purposes. The program files should
  165. not be distributed without the documentation file VUIMG.TXT.  None of the
  166. files should be modified in any way.  
  167.  
  168.  
  169. ==============================================================================
  170.  
  171.  OTHER PROGRAMS AVAILABLE FROM OFFE ENTERPRISES:
  172. -----------------------------------------------
  173.  
  174.    TBG(tm)     - TIFF black&white/grayscale image to GIF/TIFF black&white/
  175.                  grayscale converter (can reduce large b&w images to smaller
  176.                  grayscale ones for easier viewing, convert TIFF to GIF etc.).
  177.                  Commandline options for non-interactive conversion.
  178.  
  179.    SCRtoPS(tm) - Dump text and graphics screens (CGA/EGA/VGA) to PostScript
  180.                  printer or capture to Encapsulated PostScript file (including
  181.                  line/box characters).  Requires only about 10K of resident
  182.                  memory.
  183.  
  184.   Post-Screen(tm) -
  185.                - This is a post-processing program for SCRtoPS(tm) that
  186.                  allows conversion of foreground/background color information
  187.                  on captured TEXT screens into different background shades of
  188.                  of gray and different foreground thicknesses on the
  189.                  PostScript output and is extremely useful for including
  190.                  screen captures in printed manuals etc.
  191.  
  192.    See file PROGRAMS.TXT for more information on these programs.
  193.  
  194. ==============================================================================
  195.  
  196.                                TABLE OF CONTENTS
  197.  
  198.  
  199. 1.  INSTALLATION AND USAGE
  200.  
  201. 2.  PROGRAM CONFIGURATION
  202.  
  203. 3.  THE MAIN MENU
  204.     3.1  SELECTING THE FILE TYPE
  205.     3.2  SETTING THE DISPLAY MODE
  206.     3.3  DISPLAYING PICTURE FILES
  207.     3.4  TIMEOUT
  208.     3.5  ABORT PICTURE
  209.     3.6  REPEATING LISTS (CONTINUOUS SLIDE SHOW MODE)
  210.     3.7  SELECTING THE DISPLAY DIRECTORY
  211.     3.8  DIRECTORY SORT
  212.     3.9  IMAGE PRE-LOADING
  213.     3.10 SCALING OF PICTURES
  214.     3.11 TEXT SCREEN COLORS
  215.  
  216. 4.  FUNCTIONS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN
  217.     4.1  ZOOMING
  218.     4.2  PANNING
  219.     4.3  BRIGHTNESS
  220.     4.4  CONTRAST
  221.     4.5  INVERTING THE IMAGE
  222.     4.6  PRINTING
  223.     4.7  PRINTING INTERLACED GIF FILES
  224.     4.8  SUMMARY OF COMMANDS AVAILABLE WHEN A PICTURE IS
  225.          FULLY ON-SCREEN
  226.  
  227. 5.  COMMAND LINE OPTIONS
  228.  
  229. 6.  DOS EXIT CODES (ERRORLEVEL)
  230.  
  231. 7.  DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS
  232.  
  233. 8.  MISCELLANEOUS
  234.     8.1  SOME SOURCES WHERE THE LATEST SHAREWARE VERSION IS
  235.          USUALLY AVAILABLE
  236.     8.2  COMMON PROBLEMS AND SOLUTIONS
  237.     8.3  TIPS ON OBTAINING MAXIMUM PERFORMANCE
  238.     8.4  REVISION HISTORY
  239.  
  240.  
  241. ==============================================================================
  242.  
  243.  
  244. 1.  INSTALLATION AND USAGE
  245. --------------------------
  246.  
  247. Note: Requires MS-DOS Version 2.0 or later and at least 180K of free memory.
  248.  
  249. 1.  FLOPPY DISK  Copy all the files from the program disk to another floppy
  250.                  disk.  Use this as your working disk - place this disk into
  251.                  drive A:, type "A:" and press return.  Go to step 2.
  252.  
  253.     HARD DISK    Make a new subdirectory.  For example, if you are using
  254.                  drive C: and the subdirectory name you want is \VUIMAGE, enter
  255.  
  256.                           c:
  257.                           md \vuimage
  258.  
  259.                  Now make this subdirectory your current directory.  In our
  260.                  example, enter
  261.  
  262.                           cd  \vuimage
  263.  
  264.                  Copy all the files from the program disk to this subdirectory.
  265.                  Go to step 2.
  266.  
  267. 2.  Now all the files are in the current drive/directory.  To start the program,
  268.     at the DOS prompt, type the following and press return:
  269.  
  270.           vuimg       (for VUIMAGE(tm) shareware version)
  271.           vuimgp      (for VUIMAGE PLUS(tm) non-shareware version)
  272.  
  273.     You will be placed in the main menu.  Also shown will be a list of files
  274.     in the current directory that have the extension "GIF".  The current display
  275.     mode will be displayed at the bottom left of the screen.  The main menu
  276.     options are displayed at the bottom right of the screen.
  277.  
  278.     Press "Q" to quit back to DOS.  Go to step 3.
  279.  
  280. 3.  You can execute the program any time by changing to the subdirectory that
  281.     contains the program files and typing "vuimg" or "vuimgp" as applicable,
  282.     as in step 2.  However, if you would like to execute the program from any
  283.     directory, you should include the name of the directory containing the
  284.     program files as part of your "PATH".  (The PATH is a list of directories
  285.     that DOS will search when you type in a command.  Refer to your DOS manual
  286.     for information on PATH and how to add a sub-directory to your PATH.)
  287.  
  288.  
  289. ==============================================================================
  290.  
  291. 2.  PROGRAM CONFIGURATION
  292. -------------------------
  293.  
  294. VUIMAGE PLUS(tm):
  295. -----------------
  296.  
  297.     VUIMAGE PLUS(tm) users can configure the program by making selections
  298.     through the various menus and/or through commandline options, and then
  299.     saving the configuration using the "z" key within the Options menu. 
  300.     A configuration file "vuimgp.cfg" will be created in the directory 
  301.     that contains the program files (if you are using a version of DOS earlier
  302.     than DOS 3.0, this file is created in the current directory instead and
  303.     should be present in the current directory at the time the program is
  304.     started).
  305.  
  306.     If you are using an extended driver, use the "-v" commandline option to
  307.     select a driver as you start the program before saving the configuration. 
  308.     Once it has been saved, the "-v" option does not have to be specified
  309.     again.
  310.  
  311.     Commandline options can be used to override the saved configuration
  312.     (see later section on commandline options) for the current session.
  313.  
  314.  
  315. VUIMAGE(tm) (shareware version):
  316. --------------------------------
  317.  
  318.     VUIMAGE(tm) shareware version users can configure the program using 
  319.     "batch" files.  You can create a batch file by typing
  320.  
  321.           copy con: v.bat     <return>
  322.  
  323.     where "v.bat" is the name of the batch file.  Now enter the program
  324.     name along with the drive and directory name.  For example,
  325.  
  326.           c:\vuimage\vuimg    <return>
  327.  
  328.     Then press <ctrl>-Z followed by a <return> to finish creating the batch
  329.     file (you can also use an editor to create this file).  Now you can start
  330.     the program by typing "v" and return.  The batch file need not be kept
  331.     in the same subdirectory as the program files.  However, the sub-directory
  332.     that it is kept in must be part of your "PATH".  (The PATH is a list of
  333.     directories that DOS will search when you type in a command.  Refer to
  334.     your DOS manual for information on PATH and how to add a sub-directory to
  335.     your PATH).
  336.  
  337.     After you become familiar with the command line options of the program (see
  338.     later section on command line options), you can re-create the batch file 
  339.     and also specify the command line options that you normally prefer to use.
  340.     This way you can "configure" the program to suit your needs.
  341.  
  342.  
  343.  
  344. ==============================================================================
  345.  
  346. 3.  THE MAIN MENU
  347. -----------------
  348.  
  349. From the main menu, at the "File(s)" prompt, you can enter:
  350.  
  351.         - "t" to select the file type - GIF, TIFF, PCX or AUTO
  352.  
  353.         - "m" to change the display mode
  354.  
  355.         - "s" to change the scaling options, and the "image preload"
  356.           options (conventional/extended memory)
  357.  
  358.         - "o" to change other user selectable options
  359.  
  360.         - "d" to select a different directory/different group of files
  361.  
  362.         - "q" or ESC to quit and go back to DOS.
  363.  
  364.         - a list of picture files to be displayed.  For example, enter
  365.  
  366.                 3,1,5-7,17-14  <return>
  367.  
  368.            to display files 3,1,5,6,7,17,16,15,14 from the list (in that order).
  369.  
  370.         - One of the arrow keys to select files using the cursor keys.
  371.  
  372.           To display a single file, move the cursor bar to the file
  373.           and press enter.  To display a list of files, move to each file
  374.           and press the space bar to select (mark) the file.  Press enter to
  375.           display the marked files or "/" to continuously repeat the list of
  376.           files.  If there are too many files to fit on one screen, use the
  377.           PgUp/PgDn keys to see other files.
  378.  
  379.           After moving the cursor to a specific file, you can press the
  380.           "Insert" key to obtain quick information about the file.
  381.  
  382.  
  383.  
  384. ==============================================================================
  385.  
  386. 3.1  SELECTING THE FILE TYPE
  387. ----------------------------
  388.  
  389. The default file type is "AUTO".  To select TIFF, GIF or PCX explicitly,
  390. press "t" at the main menu prompt.  You can also select the file type from
  391. the command line using the "-T" option (for example, -TTIF will select TIFF -
  392. see section on command line options).
  393.  
  394.  
  395. 3.2  SETTING THE DISPLAY MODE
  396. -----------------------------
  397.  
  398. The program selects a video display mode appropriate for the video adapter
  399. and the picture being displayed automatically.  The mode is chosen from the
  400. CGA/Hercules/EGA/VGA modes present and any modes supported by any extended
  401. mode driver that has been loaded (extended mode drivers are selected by the
  402. command line option "-v" - see section "Display Boards and Extended
  403. Modes/Drivers" for more details on extended modes).  SuperVGA modes are
  404. extended modes.
  405.  
  406. If the user desires to select a particular video mode to display the picture
  407. instead of the automatically selected mode, this can be done by pressing
  408. "m" at the main menu prompt, going into the display mode menu and changing
  409. the display mode.  An appropriate mode supported by your video display
  410. board may be specified.  If any extended video mode drivers have been
  411. loaded, the extended modes supported by these drivers are also listed.
  412.  
  413. Instead of using the menu, you can also specify the mode to be used from the
  414. command line by using the "-m" option (for example, "-m7" will use the
  415. EGA 640x350 16-color mode - see section on command line options).
  416.  
  417. There is also a "BIOS" mode that you can use for extended modes that are
  418. unsupported.  Your display board will need to provide complete BIOS support.
  419. Usually the BIOS mode is extremely slow and is useful for testing purposes
  420. only.  
  421.  
  422. If you are using a video mode that has only 2 colors and you are viewing a
  423. color or grayscale image, you can use dithering to improve the displayed 
  424. picture.  Use the Options menu to select a type of dithering to be used 
  425. for 2-color modes.  A suggested dither option for 2-color displays is 
  426. 3 (3x3).  To view interlaced files correctly when dithering is used, convert 
  427. them to non-interlaced files by using the utility NINTLACE.EXE.  (See 
  428. section on interlaced files later).
  429.  
  430. ==============================================================================
  431.  
  432. 3.3  DISPLAYING PICTURE FILES
  433. -----------------------------
  434.  
  435. You can select one file or a list of files to view using one of the 
  436. following ways:
  437.  
  438. Method 1:  From the main menu, enter the number of the file you wish to
  439.            display and press return.  If you wish to display a sequence of
  440.            files, you can enter a set of numbers, separated by commas:
  441.  
  442.            Example:  3,5 <return> will display file 3 followed by file 5. 
  443.  
  444.            You can enter a starting number and an ending number to display
  445.            a list of files:
  446.  
  447.            Example:  2,5-7 <return> will display files 2, 5, 6 and 7.
  448.            Example:  2,7-5 <return> will display files 2, 7, 6 and 5.
  449.  
  450.            After you enter a list of files (or one file) and press return,
  451.            the picture(s) are displayed in sequence.
  452.  
  453. Method 2:  Alternately, you can use the cursor keys to move the cursor bar
  454.            (initially placed on file 1) to the file you wish to view, and
  455.            press enter to view the file.  To select a list of files,
  456.            "mark" each file by moving the cursor bar to it and then
  457.            pressing the space bar.  When you press return, the files
  458.            will be displayed in sequence.
  459.  
  460.        *** Methods 3 and 4 are available on VUIMAGE PLUS(tm) only. ***
  461.  
  462. Method 3:  You can specify the name(s) of the file(s) to be viewed from the 
  463.            commandline using the "-C" option.  See the section on commandline 
  464.            options.  The filename may contain wildcard characters "*" and "?".
  465.  
  466. Method 4:  You can specify from the commandline a slideshow file created by
  467.            the user that contains a list of files to be viewed using
  468.            the "-S" option.  See the section on commandline options.  
  469.  
  470.  
  471. 3.4  TIMEOUT
  472. ------------
  473.  
  474. Each picture is displayed for a default time of 20 seconds.  Pressing a
  475. return, however, will force the display to end and move on to the next
  476. picture or back to the main menu.  Pressing the backspace key will move back
  477. to the previous picture if a list of pictures is being viewed.
  478.  
  479. The timeout value can be changed from the "Options" menu or from the command
  480. line using the "-t" option - allowed values are between 0 and 43199 seconds
  481. (about 12 hours).  Setting the value to 43200 causes the timeout to be
  482. disabled.  In this case the picture will continue to be displayed
  483. until another key is pressed.  Also, if the "@" key is pressed after drawing 
  484. the picture on screen, the timeout is disabled.
  485.  
  486. If you use a screen grabber program to capture the displayed image and
  487. you are not successful, use of the "@" key may help.
  488.  
  489.  
  490. ==============================================================================
  491.  
  492. 3.5  ABORT PICTURE
  493. ------------------
  494.  
  495. Pressing the ESC key while a picture is being drawn aborts that picture.
  496. You can abort a list of pictures by pressing the ESC key twice.
  497.  
  498.  
  499. 3.6  REPEATING LISTS ( CONTINUOUS SLIDE SHOW MODE )
  500. ---------------------------------------------------
  501.  
  502. When you enter a list of pictures in the main menu, if you end the list with
  503. the forward slash ("/") instead of a <return>, the list will be continuously
  504. repeated.  To abort this repeated display, press the ESC key twice in quick
  505. succession.
  506.  
  507. In a slide show file, one can specify a "label" within the slideshow file
  508. and then use a "goto label" statement to create loops.  Slideshow files are
  509. supported only by VUIMAGE PLUS(tm).
  510.  
  511.  
  512. 3.7  SELECTING THE DISPLAY DIRECTORY
  513. ------------------------------------
  514.  
  515. From the main menu, press "d" to change the display directory (the directory
  516. containing the picture files).  The files in this directory will be listed
  517. when you return to the main menu.
  518.  
  519. If only a directory name is specified, all files that have an extension of
  520. GIF or TIF (depending on file type selected) in that directory will be
  521. displayed.  If you want to list other files also, enter an appropriate string
  522. to be matched.
  523.  
  524. Examples:        To list                                   Enter
  525.  
  526. all files in the current directory                      *.*<return>
  527.  
  528. all files with extension GIF in the current directory   *.gif<return>
  529.  
  530. all files with extension GIF or TIF (depending on       pics<return>
  531.   file type) in the subdirectory "pics" of the
  532.   current directory
  533.  
  534. all files with extension GIF or TIF (depending on       \picdir<return>
  535.   file type) in the subdirectory "picdir" of the
  536.   root directory
  537.  
  538. all files in the subdirectory "picdir" of the root      \picdir\*.*<return>
  539.         directory.
  540.  
  541. You can also set the display directory from the command line using the -d
  542. option.
  543.  
  544.  
  545. ==============================================================================
  546.  
  547. 3.8  DIRECTORY SORT
  548. -------------------
  549.  
  550. By default, the directory is sorted alphabetically.  If you press the "d" key 
  551. from the main menu, you can choose between an alphabetical sort, sort by date,
  552. sort by file size or no sort.  You can also select between a short listing with
  553. only file names and a long listing with file dates and sizes in addition.
  554.  
  555. Only the first 1020 files will be sorted in a directory.  All others are
  556. displayed unsorted.
  557.  
  558.  
  559. 3.9  IMAGE PRE-LOADING
  560. ----------------------
  561.  
  562. By default, the software will attempt to "pre-load" the image into memory
  563. before displaying it.  Pre-loaded images usually speed up Zooming and Panning
  564. significantly.  In slideshow mode, this also allows rapid switching of the
  565. screen from one image to the next.  Since the entire image has to be 
  566. pre-loaded before displaying, there is usually a waiting period before the
  567. image appears on the screen; hence in some cases you may wish to disable 
  568. pre-loading.  Image pre-loading options may be selected from the "Scale" menu.
  569.  
  570. Images are pre-loaded into conventional memory by default, but pre-loading
  571. into extended memory may be specified by the user.  An extended memory
  572. driver that conforms to the XMS specification needs to be present.
  573.  
  574. If there is insufficient memory, the image is displayed without pre-loading. 
  575.  
  576. Image pre-loading requires memory beyond the minimum requirements of 180K.
  577.  
  578.  
  579. 3.10  SCALING OF PICTURES
  580. -------------------------
  581.  
  582. There are many scaling options. The default scaling is 1:1 i.e. no scaling.
  583. You can choose to set the scales manually.  You can also have the program
  584. perform auto-scaling.  The "auto-scale full screen" option makes the picture
  585. "fit" the screen horizontally and vertically.  You can also auto-scale
  586. with the constraint that the horizontal and vertical scales should be equal.
  587.  
  588. Use the "Scale" menu to change the scaling options.  You can also select
  589. the scaling method from the command line using the -s option.
  590.  
  591.  
  592. 3.11 TEXT SCREEN COLORS
  593. -----------------------
  594.  
  595. You can change the text screen colors used by going into the "Options"
  596. menu and pressing "C - Screen Colors ".  Use the left/right arrow keys 
  597. to change the foreground color and the up/down arrow keys to change the 
  598. background color. (Alternately, you can use the "f" and "F" keys for
  599. foreground and the "b" and "B" keys for background).
  600.  
  601. Select the colors you like.  Note the numbers shown that corresponds to each
  602. of the colors that you selected - these numbers can be used with the "-cd",
  603. "-co" and the "-cg" command line options to automatically select your
  604. favourite colors when the program is started.
  605.  
  606.  
  607. ==============================================================================
  608.  
  609. 4.  FUNCTIONS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN
  610. ---------------------------------------------------------
  611.  
  612. 4.1  ZOOMING
  613. ------------
  614.  
  615. Once a picture is displayed on the screen, you can zoom in using the "+" key
  616. and zoom out using the "-" key.  To autoscale the image to fit the screen
  617. exactly, use the "a" key.  To reset Zoom/Autoscale, use the "<ctrl>-a" key.
  618.  
  619. The zoom factor may be set from the "Options" menu.
  620.  
  621.  
  622. 4.2  PANNING
  623. ------------
  624.  
  625. Once a picture is displayed on the screen, you can move the viewing window
  626. around the picture by the use of the cursor keypad (the degree of movement
  627. created by "normal panning" keys can be selected from the "Options" menu):
  628.  
  629.             (Number lock and Scroll Lock should be disabled)
  630.  
  631.           Normal Panning (user selectable degree of movement)
  632.  
  633.         down arrow  (or "d")       move down  
  634.         right arrow (or "r")       move right 
  635.         up   arrow  (or "u")       move up    
  636.         left arrow  (or "l")       move left  
  637.  
  638.                          Coarse panning
  639.  
  640.   shift-down  arrow (or "2")       move down  one screen
  641.   shift-right arrow (or "6")       move right one screen
  642.   shift-up    arrow (or "8")       move up    one screen
  643.   shift-left  arrow (or "4")       move left  one screen
  644.  
  645.   shift-"Home"      (or "7")       move to top left corner of image
  646.   shift-"End"       (or "1")       move to bottom left corner of image
  647.   shift-"PgUp"      (or "9")       move to top right corner of image
  648.   shift-"PgDn"      (or "3")       move to bottom right corner of image
  649.  
  650.                            Fine Panning
  651.  
  652.         Upper case      "U"        move up one pixel
  653.         Upper case      "D"        move down one pixel
  654.         Upper case      "L"        move left one pixel
  655.         Upper case      "R"        move right one pixel
  656.  
  657.  
  658. ==============================================================================
  659.  
  660. 4.3  BRIGHTNESS
  661. ---------------
  662.  
  663. Once a picture is displayed on the screen, you can increase the brightness
  664. by pressing the "b" key and reduce the brightness by pressing the "B" key.
  665. You can also set an overall brightness adjustment from the Options menu.
  666.  
  667. To reset the brightness, press "<ctrl>-b".
  668.  
  669.  
  670. 4.4  CONTRAST
  671. -------------
  672.  
  673. Once a picture is displayed on the screen, you can adjust the contrast
  674. by pressing the "g" key and the "G" key.  You can also set an overall
  675. contrast adjustment from the Options menu.
  676.  
  677. To reset the contrast, press "<ctrl>-g".
  678.  
  679.  
  680. 4.5  INVERTING THE IMAGE
  681. ------------------------
  682. Once a picture is displayed on the screen, you can invert the image by
  683. pressing the "i" key (available in VUIMAGE PLUS only).  This is useful
  684. for black and white or grayscale images.
  685.  
  686. Image inversion can be selected during startup by using the "-iiy"
  687. commandline option.
  688.  
  689.  
  690.  
  691. ==============================================================================
  692.  
  693. 4.6  PRINTING
  694. -------------
  695.  
  696. Once an image is displayed on the screen, you can print that image by
  697. pressing the "p" key.  Before printing, make sure that you have set up
  698. the printer port and selected the correct printer by going into the
  699. Options menu.
  700.  
  701. The entire image is printed.  Any brightness and contrast adjustments you have
  702. made will affect the print output.  The output to 2-color printers (most
  703. printers) can be dithered so as to obtain a better print-out.  You can choose
  704. between no dithering, 2x2, 3x3, 4x2, 4x4, 6x6 or 8x4 dithering by going
  705. into the Options menu.  You may wish to experiment with the dithering
  706. options to obtain the best print image.
  707.  
  708. For fairly high resolution printers (200x200 dpi or greater), 6x6 or 8x4 is
  709. suggested for paint-type images and scanned images with large number of
  710. colors or grayscales. 
  711.  
  712. For line art, either no dithering or 2x2 is suggested.  For scanned images
  713. with low number of grayscales, 2x2, 3x3 or 4x2 is suggested.
  714.  
  715. To obtain the best results, it suggested that the various print dither options
  716. be experimented with.
  717.  
  718. From the Options menu, you can also set the desired size of the print-out.
  719.  
  720. You can specify "lpt1:","lpt2:","lpt3:","com1:","com2:" or a filename
  721. for the printer port.
  722.  
  723.  
  724.  
  725. 4.7  PRINTING INTERLACED GIF FILES
  726. ----------------------------------
  727.  
  728. Interlaced GIF files are the files that contain images that are not drawn
  729. top to bottom, but are drawn in four passes over the image area.  On each
  730. pass, some lines are skipped that are subsequently filled by a following pass.
  731.  
  732. To display interlaced images using dithering in 2-color modes and also to
  733. print interlaced images, the image must be converted to a non-interlaced image.
  734. This can be done using the utility NINTLACE.EXE by typing:
  735.  
  736.           nintlace input.gif output.gif
  737.  
  738. where input.gif is the interlaced GIF file and output.gif is the non-
  739. interlaced GIF file to be created.
  740.  
  741. (If you use the "-n" option for NINTLACE.EXE as in "nintlace -n x.gif y.gif",
  742.  the program does not do this conversion, but will eliminate all unnencessary
  743.  characters from the end of the file that may have been added as a result of
  744.  using communications protocols like XMODEM or YMODEM to transfer files).
  745.  
  746.  
  747. ==============================================================================
  748.  
  749. 4.8  SUMMARY OF COMMANDS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN
  750. --------------------------------------------------------------------
  751. (Disable Scroll-Lock and Num-Lock)
  752.  
  753. @            Disable timeout, freeze pic on screen till the enter key is pressed
  754.  
  755. +, -         Zoom In, Zoom Out
  756. a, ctrl-a    Auto-scale current pic to fit screen, reset scales
  757.  
  758. arrow keys, d,r,u,l         Normal pan (down, right, up, left)
  759. shift arrow keys, 2,6,8,4   Coarse pan
  760. D,R,U,L                     Fine pan (one pixel)
  761. shift-Home, 7               Pan to top left corner
  762. shift-End,  1               Pan to bottom left corner
  763. shift-PgUp, 9               Pan to top right corner
  764. shift-PgDn, 3               Pan to bottom right corner
  765.  
  766. b, B, ctrl-b Increase brightness, decrease brightness, reset brightness
  767. g, G, ctrl-g Decrease contrast, increase contrast, reset contrast
  768. f            cycle through dithers (if being dithered)
  769. i            invert image (VUIMAGE PLUS(tm) only)
  770.  
  771. p            Print image
  772. delete       Re-draw picture
  773. insert       Show picture info
  774.  
  775. PgDn         Move to next picture in list
  776. PgUp         Move to previous picture in list
  777. escape       Abort the picture/abort the list of pictures
  778.  
  779.  
  780.  
  781. ==============================================================================
  782.  
  783. 5.0  COMMAND LINE OPTIONS
  784. -------------------------
  785.  
  786. Most of the options may be set from the command line instead going through
  787. a menu.  For example, to start the program with the mode option set to 9
  788. and the scaling option set to 3, enter:
  789.  
  790.         vuimg  -m9 -s3
  791.  
  792. The options are specified following "vuimg" or "vuimgp" as applicable, before
  793. pressing a return.  The available command line options are listed below:
  794.  
  795.   -Tfiletype    where filetype is "GIF",  "TIF",  "PCX" or "AUTO".
  796.  
  797.                 Example:   -TTIF       (display tiff files)
  798.  
  799.   -vdrivername  where drivername is the name of the extended mode driver
  800.                 appropriate for your board.  If the program files are not in
  801.                 the current directory, then the drive and subdirectory must
  802.                 also be specified.
  803.  
  804.                 Example (load ATI VGAWonder driver):
  805.  
  806.                            -vdativ            (program files in current dir)
  807.                            -vc:\vuimage\dativ (program files in c:\vuimage)
  808.  
  809.   -mmodeindex   where modeindex is the number you would enter if you were
  810.                 to go into the "Mode" menu and make a selection.
  811.  
  812.                 Example:   -m9          (set 320x200x256 mode)
  813.  
  814.   -mdmodeindex  where modeindex is the mode to be forced disabled for autoselect
  815.   -memodeindex  where modeindex is the mode to be forced enabled for autoselect
  816.   -mamodeindex  where modeindex is the mode to be not forced
  817.  
  818.                 Example:   -md11        (force disable mode 11 for autoselect)
  819.                            -me7         (force enable mode 7 for autoselect)
  820.                            -ma7         (let program decide automatically)
  821.  
  822.   -sscaleindex  where scaleindex is the number you would enter if you were
  823.                 to go into the Scale menu (part of the "Options" menu) and
  824.                 make a selection.
  825.  
  826.                 Example:   -s3          (set autoscale full screen)
  827.  
  828.   -sxhscale     where hscale is the horizontal scale value (1% to 999%).
  829.                 This option should be used only if manual scaling is selected.
  830.  
  831.                 Example:   -sx200       (set horizontal scale to 200%)
  832.  
  833.   -syvscale     where vscale is the vertical scale value (1% to 999%).
  834.                 This option should be used only if manual scaling is selected.
  835.  
  836.                 Example:   -sy50        (set vertical scale to 50%)
  837.  
  838. ==============================================================================
  839.  
  840.   -ddirectory   where directory is a directory name (or file matching string)
  841.                 that you would enter when you go into the Dir menu.
  842.  
  843.   -Dssorttype   where "sorttype" is 0 for no sort, 1 for alphabetical sort,
  844.                 2 for sort by date and 3 for sort by file size.
  845.  
  846.                 Example:   -Ds2         (sort by date)
  847.  
  848.   -Dllisttype   where "listtype" is 0 for short, 1 for long directory listing.
  849.  
  850.                 Example:   -Dl1         (show long directory listing)
  851.  
  852.   -Dddateform   where "dateform" is 0 for month-day-year format, 1 for
  853.                 day-month-year format.
  854.  
  855.                 Example:   -Dd1         (DD-MM-YY format)
  856.  
  857.   -ttimeout     where timeout is the number of seconds to display each picture.
  858.  
  859.                 Example:   -t40         (set timeout to 40 seconds)
  860.  
  861.   -by           enables the beep at the end of a picture
  862.   -bn           disables the beep at the end of the picture
  863.  
  864.                 Example:   -bn          (disable beep)
  865.  
  866.   -Bbrightness  where brightness is the brightness value (100 is nominal)
  867.  
  868.                 Example:   -B120                (set brightness to 120%)
  869.  
  870.   -Bccontrast  where contrast is the contrast value (100 is nominal)
  871.  
  872.                 Example:   -Bc80                (set contrast to 80)
  873.  
  874.   -cddircolor   where dircolor is the color number for the filenames 
  875.   -cofncolor          fncolor  is the color number for the file numbers 
  876.   -cmmodcolor         modcolor is the color number for the display mode
  877.   -cggencolor         gencolor is the color number for general text
  878.                 To find the color numbers for the colors of your choice, first
  879.                 go into the "Options" menu and select the colors that you like.
  880.                 The corresponding color numbers are also displayed.
  881.  
  882.                 Example:   -cd78    (filenames in yellow on a red background)
  883.                            -co10    (filenumbers in bright green on black)
  884.                            -cm4     (video mode in red on black)
  885.                            -cg14    (general text in yellow on black)
  886.  
  887.   -fddithertype where dithertype is the number you would enter if you were to
  888.                 go into the Options menu and choose the display dither type.
  889.  
  890.                 Example:   -fd3     (dither 2-color displays using 3x3 matrix)
  891.  
  892.   -fpdithertype where dithertype is the number you would enter if you were to
  893.                 go into the Options menu and choose the printer dither type.
  894.  
  895.                 Example:   -fp4     (dither 2-color printers using 4x4 matrix)
  896.  
  897.  
  898. ==============================================================================
  899.  
  900.   -iby          show brief info (-iby) as pic is displayed (filename, image
  901.   -ibn          size),  do not show brief info (-ibn)
  902.  
  903.   -idy          show detailed info (-idy) as pic is displayed,
  904.   -idn          do not show detailed info (-idn)
  905.  
  906.   -iiy          invert the image (-iiy), do not invert the image (-iin).
  907.   -iin          (really useful for only black and white/grayscale images)
  908.  
  909.   -igy          show GIF89a Comments (-igy), do not show GIF89a Comments (-ign)
  910.   -ign          
  911.  
  912.  
  913.   -woxoffsetx   where "offsetx" is the horizontal offset of window,
  914.   -woyoffsety         "offsety" is the vertical offset of window,
  915.   -wxsizex            "sizex" is the horizontal window size,
  916.   -wysizey        and "sizey" is the vertical window size
  917.                 of a window on the screen to display the picture in.
  918.                 All dimensions are in number of pixels.
  919.  
  920.                 Example:   -wox100 -woy50 -wx240 -wy160  (display in a 
  921.                                 window of size 240x160, offset by 100x50)
  922.  
  923.   -wcy          center image within display window
  924.   -wcn          place image at top left corner of display window
  925.  
  926.   -ul0          unit is inches.
  927.   -ul1          unit is cm.
  928.  
  929.   -q            Exit from the program (useful in slideshow files)
  930.  
  931.  
  932.  
  933. ==============================================================================
  934.  
  935. (*** The following options are available only in VUIMAGE PLUS(tm) ***)
  936.  
  937.   -pprinternum  where printernum is the number you would enter if you were
  938.                 to go into the Options menu and choose a printer.
  939.  
  940.                 Example:   -p1      (select EPSON FX80/100 printer)
  941.  
  942.   -pddevicename where devicename is the printer device (lpt1:, lpt2:, lpt3:,
  943.                 com1:, com2: or filename).
  944.  
  945.                 Example:   -pdlpt1:      (send output to lpt1:)
  946.                            -pdvuimg.prn  (send output to file vuimg.prn)
  947.  
  948.   -pxwidth      where width is the width of the printed image in 1/100 inches
  949.  
  950.                 Example:   -px904   (print image width=9.04 inches)
  951.  
  952.   -pyheight     where height is the height of the printed image in 1/100 inches
  953.  
  954.                 Example:   -py1200  (print image height=12.00 inches)
  955.  
  956.   -pDy          disable the print capability
  957.   -pDn          enable  the print capability
  958.  
  959.   -C            disables the menus.  If you use this option, you must also
  960.   -Cp           specify a filename to be displayed including the pathname.
  961.                 This should be the last option entered on the command line.
  962.                 The filename may contain wild card characters ? and * and 
  963.                 should be the last parameter.  Any directory name entered
  964.                 with the -d option will be ignored.  If the "-Cp" option is
  965.                 used instead of the "-C", the image is also printed.
  966.  
  967.                 Examples:   -C somefile.gif
  968.                             -C \pics\*.gif
  969.                             -Cp image.tif
  970.  
  971.   -L            leave the last image on the screen when the program ends.
  972.                 Valid only when the -C option is used.  Useful when called
  973.                 as a sub-program by another program.
  974.  
  975.   -l            do not reset the video mode or clear the screen between images.
  976.                 Valid only when the -C option is used.  This option is useful
  977.                 only if the images being viewed are close enough in size,
  978.                 resolution and colors that the video mode and the palette will
  979.                 be the same for the images.  Not recommnded for use unless
  980.                 this is the case.  It is recommended that an appropriate
  981.                 video mode should be specified instead of using auto-select.
  982.  
  983. ==============================================================================
  984.  
  985.   -S            specify the name of a slideshow file created by the user
  986.                 using a text editor that contains a list of files to be shown.
  987.                 This file may also contain other commandline options.
  988.                 For example, you can enter
  989.  
  990.                            vuimgp -S slidshow.1
  991.  
  992.                 where the file "slidshow.1" contains
  993.  
  994.                       --------------------------
  995.                      | -m0 -s3                  | <- startup parameters
  996.                      | -C file1.gif             | <- show file1.gif
  997.                      | -m8 -C file2.gif         | <- show file2.gif
  998.                      | -s1 -m0 -C file3.gif     | <- show file3.gif
  999.                      | -q                       |
  1000.                       --------------------------
  1001.  
  1002.                 The lines within the file are executed in sequence.
  1003.                 PgDn and PgUp keys may be used to go forwards and 
  1004.                 backwards in the list of images during display.
  1005.                 The "-Cp" and "-S" options should not be used within this file.
  1006.                 However, it is possible to create effects such as multiple
  1007.                 images on one screen by using the "-l" option along with the 
  1008.                 windowing options "-wx, -wy, -wox, -woy".  A specific video
  1009.                 mode should be selected using the "-m" option if this is
  1010.                 attempted.
  1011.  
  1012.   -zfzoomfactor where "zoomfactor" is the Zoom Factor in percentage.
  1013.  
  1014.                 Example:   -zf200   (sets Zoom to 200%)
  1015.  
  1016.   -zppanpercent where "panpercent" is the percentage (of the screen) to move
  1017.                 when one of the "normal panning" keys (down,up,right and left
  1018.                 arrow) is pressed.
  1019.  
  1020.                 Example:   -zp4     (move by 4%)
  1021.  
  1022.   -edry         the default mode when editing (changing selections) is replace
  1023.   -edrn         the default mode when editing (changing selections) is insert
  1024.  
  1025.   -MX           pre-load into extended memory (XMS)
  1026.   -MC           pre-load into conventional memory
  1027.   -MN           do not pre-load
  1028.  
  1029.  
  1030. ==============================================================================
  1031.  
  1032. 6.0  DOS EXIT CODES (ERRORLEVEL)
  1033. --------------------------------
  1034.  
  1035. The return codes generated by the program that may be tested in a batch
  1036. file are:
  1037.  
  1038. 0  - no error
  1039. 1  - command line option error
  1040. 2  - the -C option was used without specifying a file
  1041. 3  - file not found or invalid filename
  1042. 12 - slideshow file not specified
  1043. 13 - Error opening the slideshow file
  1044. 14 - commnd line option error within the slideshow file
  1045.  
  1046.  
  1047. ==============================================================================
  1048.  
  1049. 7.  DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS
  1050. ---------------------------------------------------
  1051.  
  1052. If the program does not work with your graphics display board, try loading any 
  1053. software drivers (BIOS emulators, int 10h drivers, RAM BIOS drivers) that came
  1054. with the display board that may be needed.  Refer to the instructions that 
  1055. come with your graphics board.
  1056.  
  1057. Some graphics display boards support even higher resolutions than standard VGA,
  1058. for example, 640x480 in 256 colors and 800x600 in 16 colors.  These are
  1059. sometimes referred to as SuperVGA modes.  Additional drivers that support
  1060. these "extended modes" are included with the program.  These drivers have
  1061. filenames with the extension ".VDR" and are listed later in this section.
  1062. They can be loaded using the "-v" command line option (see section on command
  1063. line options).
  1064.  
  1065. Typically, extended modes are dependent on your type of graphics card.
  1066. Refer to your graphics card manual to see what extended modes are supported.
  1067. Only VGA type extended modes with either 16 or 256 colors out of a palette
  1068. of 262,144 colors are supported by the extended mode drivers.  Check the
  1069. list of extended mode drivers at the end of this section to see which driver
  1070. is suitable for use with your card.  Some of the modes listed may not be
  1071. available in your specific card.  The unavailable modes can be AND SHOULD BE
  1072. disabled by using the "-md" commandline option, or by using the "Mode menu",
  1073. so that the Auto-select videomode function does not try to use these modes.
  1074. Saving the configuration in VUIMAGE PLUS(tm) will also save this information
  1075. if it was specified on the commandline as the program is started.
  1076.  
  1077. However, there is a SuperVGA standard known as the VESA SuperVGA standard.
  1078. Many or most of the SuperVGA cards now support this standard.  If your
  1079. card supports this standard, then you can take advantage of the VESA driver
  1080. (DVESA.VDR) that comes with the program.  Even if there is a separate driver
  1081. that supports your card, WE RECOMMEND that you use the VESA driver instead
  1082. if your card supports the VESA standard.  In order for your card to support
  1083. the VESA standard, you may need to load a device driver or TSR that comes
  1084. with your card (through the CONFIG.SYS or AUTOEXEC.BAT file).  Refer to the
  1085. documentation that comes with your card (in printed form or disk file form).
  1086.  
  1087. If you are not using any extended drivers, you may still be able to display
  1088. in an extended mode if your BIOS for the board will support this.  Not all
  1089. boards come with BIOS that support the extended modes completely.  Installing
  1090. any RAM BIOS drivers that come with your board may help.  Display done
  1091. through the BIOS is usually extremely slow. 
  1092.  
  1093. To use the BIOS supported extended modes, you need to know the mode number,
  1094. the no. of columns, the no. of rows, and the no. of colors for the mode.
  1095. Refer to the manual for your graphics card.  Make sure to try only modes
  1096. that are actually available on your board.
  1097.  
  1098. If you have a plain VGA card with no SuperVGA modes, you may still be able
  1099. to get higher resolutions (320x400x256, 360x480x256, 800x600x16, 400x600x256)
  1100. using the DNVGA driver.
  1101.  
  1102. ==============================================================================
  1103.  
  1104. Extended Mode Drivers (SuperVGA drivers) included:
  1105. -------------------------------------------------
  1106.  
  1107. Note: Some of the modes listed may not be available in your specific card.
  1108.       These should be disabled (see section above).  Additional drivers may be
  1109.       available from Offe Enterprises.
  1110.  
  1111.     If your display board is:                   Driver
  1112.     ------------------------                    -------
  1113.  
  1114.     Any board that supports the VESA SuperVGA   DVESA
  1115.     standard and has VESA BIOS installed
  1116.  
  1117.     8514/A AI Compatibles (AI must be loaded)   D8514AI
  1118.  
  1119.     8514/A 100% register compatibles            D8514R
  1120.  
  1121.     Orchid Farenheit 1280 (S3 86C911 Chipset)   DS3911
  1122.  
  1123.         (Many of the following cards come with VESA BIOS support in the form
  1124.         of a "TSR" that can be loaded into memory.  In such cases, this TSR
  1125.         should be loaded, and the "DVESA" driver specified to VUIMAGE(tm)
  1126.         instead of the driver listed below.
  1127.  
  1128.         8514/A Register Compatibles             D8514R
  1129.         Ahead Systems VGA Wizard                DAHEADB
  1130.         AST VGA cards                           DPVGA
  1131.         ATI Prism Elite                         DTRID
  1132.         ATI VGAWonder                           DATIV
  1133.         ATI Graphics Ultra (SuperVGA modes)     DATIV, D8514R or D8514AI**
  1134.         ATI Graphics Vantage (SuperVGA modes)   DATIV, D8514R or D8514AI**
  1135.         AT&T VDC600                             DPVGA
  1136.         BOCA w/Tseng 4000 Chipset               DTSNG4
  1137.         Cardinal 600 VGA                        DCHT
  1138.         Chips & Technologies                    DCHT
  1139.         Everex EV673                            DE673
  1140.         Everex EV678                            DE678
  1141.         Genoa 6400                              DORCH
  1142.         Genoa 5400                              DORCH
  1143.         Genoa 5300                              DORCH
  1144.         Hercules Graphics Station               DHGS
  1145.         IMTEC                                   DTRID
  1146.         LOGIX                                   DTRID
  1147.         MAXXON                                  DTRID
  1148.         Northgate Pro                           DV7VRAM
  1149.         Oak Technologies                        DOAK
  1150.         Orchid Farenheit 1280                   DS3911
  1151.         Orchid ProDesigner                      DORCH
  1152.         Orchid ProDesigner II (Tseng 4000)      DTSNG4
  1153.         Paradise VGA Professional               DPVGA
  1154.         Paradise Image Sharpener (NVGA-P1D)     DVESA
  1155.         Sigma VGA cards                         DORCH
  1156.         Standard IBM VGA & register compatibles
  1157.                 with multisync monitors         DNVGA
  1158.         Older STB VGA cards                     DORCH
  1159.         STB PowerGraph (Tseng 4000)             DSTBPG, DVESA or D8514AI**
  1160.         Tandy 1000 (320x200x16)                 DTANDY
  1161.         Trident Video cards                     DTRID
  1162.         Video-7 Fastwrite                       DV7FW
  1163.         Video-7 1024i                           DV71024
  1164.         Video-7 VRAM                            DV7VRAM
  1165.  
  1166. ==============================================================================
  1167.  
  1168.         Other Chips&Technolgies chipset cards   DCHT
  1169.         Other Paradise VGA cards                DPVGA
  1170.         Other Trident chipset cards             DTRID
  1171.         Other Tseng 3000 Chipset cards          DORCH
  1172.         Other Tseng 4000 Chipset cards          DTSNG4
  1173.         Oak Technologies Chipset cards          DOAK
  1174.         NCR Chipset cards                       DNCR
  1175.         Cirrus Chipset cards                    DCIRR
  1176.         S3 86C911 Chipset cards                 DS3911
  1177.         IBM PS/2 25SX/35/40/56/57               DVESA*
  1178.  
  1179.      * the VESA driver (TSR) that comes with the board, or available from
  1180.        the manufacturer, must be loaded.
  1181.     ** the AI driver that comes with the board must be loaded.
  1182.  
  1183.     All extended modes supported by the driver may not be available on your
  1184.     board.  Some may simply be unavailable, some may require more memory.
  1185.     To see which extended modes supported by the driver are available on
  1186.     your graphics card, refer to the manual that comes with the card.
  1187.     MODES SUPPORTED BY THE DRIVER THAT ARE NOT AVAILABLE IN YOUR CARD
  1188.     SHOULD BE DISABLED USING THE "-md" COMMANDLINE OPTION.
  1189.  
  1190.     All extended modes available on a board may not be supported by the driver.
  1191.  
  1192.  
  1193. Extended Modes Supported by the Drivers (mode numbers in decimal and hex)
  1194.  
  1195. DVESA
  1196.         Mode 256  (100h)         640 x  400 x 256 colors
  1197.         Mode 257  (101h)         640 x  480 x 256 colors
  1198.         Mode 258  (102h)         800 x  600 x  16 colors
  1199.         Mode 259  (103h)         800 x  600 x 256 colors
  1200.         Mode 260  (104h)        1024 x  768 x  16 colors
  1201.         Mode 261  (105h)        1024 x  768 x 256 colors
  1202.         Mode 262  (106h)        1280 x 1024 x  16 colors
  1203.         Mode 263  (107h)        1280 x 1024 x 256 colors
  1204.  
  1205. D8514AI (requires AI to be loaded via "hdiload")
  1206. D8514R  (8514/A 100% register compatibles)
  1207.  
  1208.                                 640 x 480 x  16 colors  ( 512K)
  1209.                                1024 x 768 x  16 colors  ( 512K)
  1210.                                 640 x 480 x 256 colors  (1 MEG)
  1211.                                1024 x 768 x 256 colors  (1 MEG)
  1212.  
  1213. DAHEADB
  1214.         Mode 106 (6Ah)           800 x 600 x  16 colors
  1215.         Mode 113 (71h)           800 x 600 x  16 colors
  1216.         Mode 116 (74h)          1024 x 768 x  16 colors
  1217.         Mode  96 (60h)           640 x 400 x 256 colors
  1218.         Mode  97 (61h)           640 x 480 x 256 colors
  1219.         Mode  98 (62h)           800 x 600 x 256 colors
  1220.         Mode  99 (63h)          1024 x 768 x 256 colors
  1221.  
  1222. ==============================================================================
  1223.  
  1224.  
  1225. DATIV
  1226.         Mode  84 (54h)           800 x 600 x  16 colors 
  1227.         Mode  97 (61h)           640 x 400 x 256 colors
  1228.         Mode  98 (62h)           640 x 480 x 256 colors
  1229.         Mode  99 (63h)           800 x 600 x 256 colors
  1230.         Mode 101 (65h)          1024 x 768 x  16 colors
  1231.         Mode  85 (55h)          1024 x 768 x  16 colors
  1232.  
  1233. DCHT
  1234.         Mode 112 (70h)           800 x 600 x  16 colors 
  1235.         Mode 114 (72h)          1024 x 768 x  16 colors
  1236.         Mode 120 (78h)           640 x 400 x 256 colors
  1237.         Mode 121 (79h)           640 x 480 x 256 colors
  1238.         Mode 128 (7bh)           800 x 600 x 256 colors
  1239.  
  1240. DCIRR
  1241.         Mode  99 (63h)           720 x 540 x  16 colors 
  1242.         Mode 100 (64h)           800 x 600 x  16 colors 
  1243.         Mode 106 (6Ah)           800 x 600 x  16 colors 
  1244.         Mode  97 (61h)           640 x 400 x  16 colors (GD5320)
  1245.         Mode  98 (62h)           640 x 450 x  16 colors (GD5320)
  1246.         Mode 112 (70h)           360 x 480 x 256 colors (GD5320)
  1247.         Mode 113 (71h)           528 x 400 x 256 colors (GD5320)
  1248.         Mode 114 (72h)           528 x 480 x 256 colors (GD5320)
  1249.         Mode 116 (74h)           320 x 240 x 256 colors (GD5320)
  1250.         Mode 117 (75h)           640 x 400 x 256 colors (GD5320)
  1251.  
  1252. DE673
  1253.         Submode 19 (13h)        640 x 350 x 256 colors
  1254.         Submode 20 (14h)        640 x 400 x 256 colors
  1255.         Submode 21 (15h)        512 x 480 x 256 colors
  1256.  
  1257. DE678
  1258.         Submode 49 (31h)        640 x 400 x 256 colors
  1259.         Submode 50 (32h)        512 x 480 x 256 colors
  1260.         Submode 77 (4dh)        640 x 480 x 256 colors
  1261.         Submode 78 (4eh)        800 x 600 x 256 colors
  1262.  
  1263. DHGS
  1264.                                 640 x 480 x 256 colors
  1265.                                 800 x 600 x 256 colors
  1266.                                1024 x 768 x 256 colors
  1267. DNCR
  1268.         Mode  88 (58h)           800 x 600 x  16 colors
  1269.         Mode  93 (5Dh)          1024 x 768 x  16 colors
  1270.         Mode  94 (5Eh)           640 x 400 x 256 colors
  1271.         Mode  95 (5Fh)           640 x 480 x 256 colors
  1272.         Mode  92 (5Ch)           800 x 600 x 256 colors
  1273.  
  1274. DNVGA
  1275.         -------                  320 x 400 x 256 colors
  1276.         -------                  360 x 480 x 256 colors
  1277.         -------                  800 x 600 x  16 colors
  1278.         -------                  400 x 600 x 256 colors
  1279.  
  1280. ==============================================================================
  1281.  
  1282. DOAK
  1283.         Mode  82 (52h)           800 x 600 x  16 colors
  1284.         Mode  83 (53h)           640 x 480 x 256 colors
  1285.         Mode  84 (54h)           800 x 600 x 256 colors
  1286.         Mode  86 (56h)          1024 x 768 x  16 colors
  1287.  
  1288. DORCH
  1289.         Mode  41 (29h)           800 x 600 x  16 colors
  1290.         Mode  45 (2Dh)           640 x 350 x 256 colors
  1291.         Mode  46 (2Eh)           640 x 480 x 256 colors
  1292.         Mode  47 (2Fh)           720 x 512 x 256 colors
  1293.         Mode  48 (30h)           800 x 600 x 256 colors
  1294.         Mode  55 (37h)          1024 x 768 x  16 colors
  1295.  
  1296. DPVGA
  1297.         Mode  88 (58h)           800 x 600 x  16 colors
  1298.         Mode  94 (5Eh)           640 x 400 x 256 colors
  1299.         Mode  95 (5Fh)           640 x 480 x 256 colors
  1300.  
  1301. DV7FW
  1302.         Mode  98 (62h)           800 x 600 x  16 colors
  1303.         Mode 102 (66h)           640 x 400 x 256 colors
  1304.         Mode 103 (67h)           640 x 480 x 256 colors
  1305.  
  1306. DTANDY
  1307.         Mode  9  (09h)           320 x 200 x  16 colors
  1308.  
  1309. DTRID
  1310.         Mode  91 (5Bh)           800 x 600 x  16 colors
  1311.         Mode  92 (5Ch)           640 x 400 x 256 colors
  1312.         Mode  93 (5Dh)           640 x 480 x 256 colors
  1313.         Mode  94 (5Eh)           800 x 600 x 256 colors
  1314.         Mode  95 (5Fh)          1024 x 768 x  16 colors
  1315.         Mode  98 (62h)          1024 x 768 x 256 colors
  1316.  
  1317. DTSNG4, DSTBPG
  1318.         Mode  41 (29h)           800 x 600 x  16  colors
  1319.         Mode  55 (37h)          1024 x 768 x  16  colors
  1320.         Mode  45 (2dh)           640 x 350 x 256  colors
  1321.         Mode  47 (2fh)           640 x 400 x 256  colors (DTSNG4)
  1322.         Mode 120 (78h)           640 x 400 x 256  colors (DSTBPG)
  1323.         Mode  46 (2eh)           640 x 480 x 256  colors
  1324.         Mode  48 (30h)           800 x 600 x 256  colors
  1325.         Mode  56 (38h)          1024 x 768 x 256  colors
  1326.  
  1327. DV71024
  1328.         Mode  98 (62h)           800 x 600 x  16 colors
  1329.         Mode 101 (65h)          1024 x 768 x  16 colors
  1330.         Mode 102 (66h)           640 x 400 x 256 colors
  1331.         Mode 103 (67h)           640 x 480 x 256 colors
  1332.  
  1333. DV7VRAM
  1334.         Mode  98 (62h)           800 x 600 x  16 colors
  1335.         Mode 101 (65h)          1024 x 768 x  16 colors
  1336.         Mode 102 (66h)           640 x 400 x 256 colors
  1337.         Mode 103 (67h)           640 x 480 x 256 colors
  1338.         Mode 105 (69h)           800 x 600 x 256 colors
  1339.  
  1340.  
  1341. ==============================================================================
  1342.  
  1343. 8.  MISCELLANEOUS
  1344. -----------------
  1345.  
  1346. 8.1  SOME SOURCES WHERE THE LATEST SHAREWARE VERSION IS USUALLY AVAILABLE
  1347. -------------------------------------------------------------------------
  1348.  
  1349.   1. The Offe Enterprises BBS - 708-357-6680 Files Section
  1350.                  - Filename VUIMGxyz.* where xyz is the version number.
  1351.  
  1352.   2. The Wheaton File Exchange - Files section
  1353.                  - USA-708-462-1508,  USA-708-462-1509
  1354.                  - Filename VUIMGxyz.* where xyz is the version number.
  1355.  
  1356.   3. Compuserve  - PICS (GRAPHICS SUPPORT) forum, library 3.
  1357.                  - Enter "browse vuim*.*" in library 3 to list.
  1358.  
  1359.   4. EXEC-PC BBS - "Free download area for all callers" sub-section of the 
  1360.                    Files section of the BBS
  1361.                  - (414)-789-4210
  1362.                  - Filename VUIMGxyz.* where xyz is the version number.
  1363.  
  1364.  
  1365. 8.2  COMMON PROBLEMS AND SOLUTIONS
  1366. ----------------------------------
  1367.  
  1368. 1.  While attempting to display a picture,
  1369.  
  1370.            a) the screen dims, or
  1371.            b) the screen changes color, or
  1372.            c) nothing happens
  1373.  
  1374.     and the picture is not displayed.  After some time, a beep is heard
  1375.     and if the return key is pressed, the main menu returns.
  1376.  
  1377.     The most likely cause of the problem is that a video mode that is not
  1378.     available in your video adapter is being used.  This usually happens
  1379.     when the "autoselect video mode" feature is on, and an extended video
  1380.     driver is specified.
  1381.           
  1382.     To solve the problem, go to the "Mode" menu from the main menu, and
  1383.     determine what modes are NOT available by following this procedure.
  1384.  
  1385.         a) Select each of the modes marked by an asterisk manually
  1386.         b) Try to display a picture
  1387.  
  1388.     The modes that do not work should be disabled using the "-md"
  1389.     commandline option (see section on "DISPLAY BOARDS and EXTENDED 
  1390.     VIDEO MODES/DRIVERS" for more information).  VUIMAGE PLUS(tm)
  1391.     users need to specify this through the commandline option only once
  1392.     if the configuration is subsequently saved.
  1393.  
  1394.  
  1395. ==============================================================================
  1396.  
  1397. 2.  How do I print ?
  1398.  
  1399.     Go to the Options menu and select the printer type and printer port,
  1400.     and the print dither type.  Once a picture has been displayed on the
  1401.     screen, press the "p" key.  For more information, read the sub-section
  1402.     "PRINTING".
  1403.  
  1404. 3.  The printed image appears in four bands of different heights.
  1405.  
  1406.     Most likely, you are trying to print an interlaced GIF file.  Read the
  1407.     sub-section titled "PRINTING INTERLACED GIF FILES".
  1408.  
  1409. 4.  My printed image quality could be better.
  1410.  
  1411.     You may be using a print dither inappropriate for the image.  See 
  1412.     sub-section on "PRINTING".
  1413.  
  1414. 5.  I would like to see a specific feature added to the program.
  1415.  
  1416.     You can write or call Offe Enterprises.  Features requested by larger
  1417.     number of registered users are given higher priority.  (Note, however,
  1418.     that no guarantee can be given that the feature will be incorporated
  1419.     in a future release.)
  1420.  
  1421. 6.  While starting up the program, I get an error message about "STACK"
  1422.     such as "Stack Overflow"
  1423.  
  1424.     This could be due to two reasons.  There may not be sufficient memory
  1425.     to run the program, or, you could have a large amount of memory used
  1426.     up by "Environment Variables".  Some shell replacements for the file
  1427.     "COMMAND.COM", as well as COMMAND.COM files modified to specifically
  1428.     do this, allow a large amount of memory to be used for environment
  1429.     variables.  Often it is easy to reduce the memory taken up this
  1430.     way by the use of batch files which create only temporary environment
  1431.     variables (the variables are set at the beginning of the batch file,
  1432.     and destroyed at the end of the batch file).
  1433.  
  1434.     Note:  Environment Variables are variables that are set using the "SET"
  1435.     command, such as "SET HOME=C:\DATADIR\MYNAME".
  1436.  
  1437.  
  1438. ==============================================================================
  1439.  
  1440. 8.3  TIPS ON OBTAINING MAXIMUM PERFORMANCE
  1441. ------------------------------------------
  1442.  
  1443. 1.  You can obtain higher quality images on the screen by the use of
  1444.     SuperVGA, 8514/A or other high resolution graphics board for which
  1445.     a driver is included (see section on DISPLAY BOARDS and EXTENDED 
  1446.     VIDEO MODES/DRIVERS).
  1447.  
  1448.     A board that provides VESA SuperVGA compatibility (such a board comes
  1449.     with VESA Bios support) or 8514/A AI compatibility (such a board comes
  1450.     with an AI driver) may give the best performance with VUIMAGE(tm).
  1451.  
  1452. 2.  If your board has VESA Bios or 8514/A AI compatibility, use it in the
  1453.     VESA SuperVGA or 8514/A AI compatible mode (follow instructions that came
  1454.     with your board on how to do this), and specify either the "dvesa" or 
  1455.     "d8514ai" driver as appropriate EVEN IF one of the other drivers will work.
  1456.  
  1457. 3.  Make sure to disable all SuperVGA video modes that are provided by a
  1458.     driver but are unavailable in your system.  Also, if two video modes
  1459.     are available in the same resolution but one is 16-color and the other
  1460.     is 256-color (example:  800x600x16 and 800x600x256), disable the
  1461.     16-color mode.
  1462.  
  1463. 4.  Install extended memory in the machine, if possible, and specify to
  1464.     VUIMAGE(tm) that extended memory is to be used (this can be done from
  1465.     the "Scale" menu).  More extended memory will be required for larger
  1466.     images.  At least two megabytes is suggested.
  1467.  
  1468. 5.  Select a "pan percentage" from the Options menu that is suitable for
  1469.     your system, if you "pan" over images.
  1470.  
  1471. 6.  When printing, choose a "print dither" option that is suitable for the
  1472.     image and the printer.
  1473.  
  1474.  
  1475.  
  1476. ==============================================================================
  1477.  
  1478. 8.4  REVISION HISTORY
  1479. ---------------------
  1480.  
  1481. Additions/Changes from Version 3.30 to Version 3.31:
  1482.   - display is faster in the EGA & VGA 2-color and 16-color modes
  1483.   - handles compressed bilevel TIFF files (compression type CCITT G3-1D, 
  1484.     CCITT Group 4 or Packbits) 
  1485.   - the way GIF89a comments are displayed has changed - the comments are
  1486.     now all shown at the end of the image.  To prevent the comments from
  1487.     being displayed, use the "-ign" commandline option.
  1488.  
  1489. Additions/Changes from Version 3.20 to Version 3.30:
  1490.   - added the ability to "preload" the image into conventional or
  1491.     Extended memory (XMS) for quicker Zoom/Pan.  Also results in quick
  1492.     switch from one picture to the next during slideshows.
  1493.   - the "dvesa" driver now provides added capabilities that improves
  1494.     scrolling in SuperVGA modes.  If one of the "dvesa" or the "d8514ai" 
  1495.     drivers will work for you, their use is recommended.
  1496.   - The degree of movement (pan) obtained when one of the normal panning 
  1497.     keys (down, up, left and right arrows) is user selectable from the
  1498.     "Options" menu and can also be specified by the "-zp" commandline option.
  1499.   - added commandline Options "-edry" and "-edrn" (sets the default edit mode)
  1500.   - added Landscape print mode for HP Laserjets.
  1501.   - increased printing speed, and added ability to specify top and left
  1502.     margins on HP Laserjets.  Added commandline options "-pt" and "-pl"
  1503.     for this purpose.
  1504.   - added ability to perform "loop"s within a slideshow file.
  1505.   - increased maximum width of images that can be handled
  1506.   - "center image on screen" is now the default
  1507.   - expands tabs when displaying text files
  1508.  
  1509. Additions/Changes from Version 3.15 to Version 3.20:
  1510.   - added ability to view Text files (ASCII)
  1511.   - added ability to select filetype automatically based on the filename
  1512.   - supports multiple quick pans (arrow keys pressed in quick succession)
  1513.   - "normal pan" now moves by 1/4 of screen for GIF/PCX instead of 1/2 screen
  1514.   - "coarse pan" now moves by 1/2 of screen instead of full screen
  1515.   - CHANGED MODE MENU: now allows enabling/disabling modes from within the
  1516.     menu (for auto-select video mode)
  1517.   - displays "extended video driver" name within the mode menu
  1518.   - added pre-scaling options 7 and 8
  1519.   - added 8514/A drivers: 8514AI for AI compatibles (requires AI to be loaded),
  1520.                           8514R for register compatibles
  1521.   - added scaling options 7 and 8
  1522.   - "-wcy", "-wcn" and "-q" commandline options added
  1523.   - supports additional PCX format variations
  1524.   - VUIMAGE PLUS(tm) now supports multi-image TIFF files
  1525.  
  1526. Additions/Changes from Version 3.11 to Version 3.15:
  1527.   - PgDn and PgUp keys now move to the next/previous file in list
  1528.     (use shift-PgUp/shift-PgDn/shift-Home/shift-End to move to corners of pic)
  1529.   - fine panning keys "U","D","R","L" added (pans by one pixel)
  1530.   - added help key ("h") while image is on screen
  1531.   - added user programmable Zoom Factor (101% to 400%)
  1532.   - added ability to center image on screen (if image is smaller than screen)
  1533.   - Faster multiple zooms (+/- keys pressed in quick succession)
  1534.   - added DNCR driver, DCIRR driver
  1535.   - timeout value of 43200 now disables timeout, waits for user to press enter
  1536.   - "-Bc" commandline option added for contrast
  1537.   - "-ul1", "-ul0" commandline options added to select cm/inch units
  1538.   - "-C" option accepts multiple filenames in addition to wildcard characters
  1539.   - "-pDy" commandline option added to disable print (VUIMAGE PLUS(tm) only)
  1540.   - memory requirement has increased to 180K
  1541.  
  1542. Additions/Changes from Version 2.96 to Version 3.11:
  1543.   - VUIMAGE(tm) now supports PCX
  1544.   - VUIMAGE PLUS(tm) now supports a slideshow file facility ("-S" option)
  1545.   - improved printing speed 
  1546.   - can display pictures in a window on the screen (commandline options
  1547.     added: -wx, -wy, -wox, -woy)
  1548.   - added EPSON LQ2500 360x180 dpi mode, 24 -pin, and IBM Proprinter X24
  1549.   - added TIFF Group IV support to VUIMAGE PLUS(tm)
  1550.   - added 8x4 and 4x2 dither options (deleted 5x5 dither option)
  1551.   - VUIMAGE PLUS can display TIFF 24bit rgb triplet uncompressed images
  1552.     in 256 color mode
  1553.   - added Hercules Graphics Station driver.
  1554.   - added Ahead Systems VGA Wizard Deluxe Driver (VGA-V-5000B chipset)
  1555.   - added 1024x768x256 mode to DV7VRAM driver 
  1556.   - now prints message "Printing.." while printing
  1557.   - handles more TIFF Files
  1558.   - added ability to read GIF files with 128 byte header (MAC->IBM format)
  1559.   - increased max print width at 300 dpi.
  1560.  
  1561.  
  1562.